home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 January / macformat-020.iso / Shareware City / Developers / Commander Sets / 4D Speech Pack / 4D Speech Pack.rsrc / TEXT_13559_†SP SPEECH OFF.txt < prev    next >
Encoding:
Text File  |  1994-09-14  |  1.7 KB  |  27 lines

  1. SP SPEECH OFF
  2.  
  3. Disables Speech Pack in order to temporarily stop any function to speak text.
  4.  
  5. You can use this command to temporarily turn speech off without using a special variable to test in every occurence were you otherwise would want to call a function to speak text. I.e. when you want to call a procedure which normally uses Speech Pack to read out some text, but this time you are sure you don't want that to happen since you're now using non-English text. Or to allow the user to switch Speech Pack on and off by using a (radio/checkbox) button without closing all
  6. voices (using the data-base while also talking to someone on the telephone!). You then need to ignore error number -205.
  7.  
  8. All functions and commands which do not produce speech are normally available. 
  9. This command has no effect to other applications which use the Speech Manager, only with Speech Pack. It does not cause any speech to stop when it is called, it simply doesn't allow any new text to start to speak.
  10.  
  11. After this command is executed all Speech Pack functions who produce speech are disabled. These are:
  12.  ‚Ä¢ SP Voice String
  13.  ‚Ä¢ SP Voice Text
  14.  ‚Ä¢ SP Speak String
  15.  ‚Ä¢ SP Speak Text
  16.  ‚Ä¢ Say
  17.  ‚Ä¢ PARLE
  18.  
  19. The functions which return an error number will do so (error -205) when you call them when Speech Pack is disabled. The functions which don't return an error number will beep instead of speaking the text. If you call the SP Voice Text function with a flags value which would cause to pause immediatly without actually producing any sound, an error is returned also.
  20.  
  21. Speech Pack can be enabled again by using the SP SPEECH ON command. You can use the function SP Can speak to test if Speech Pack is currently disabled.
  22.  
  23. Example:
  24.   SP SPEECH OFF
  25.  
  26.  
  27.